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PNP SCOME tL ON 


Data Comm Audit CDC/ZAUDIT) is a utility program written to monitor 
RJE» HASP» and NOL Line activity.» This audit mechanism is a 
valuable tool for initial installation of data comm systems and for 
detection and-ronitoring of line-oriented proolems. 


On the completion of each data comm IQ» the handler writes 
information regarding the I0 into a disk file that can be printed 
by CEPC/AUDIT. The audit option in RJE» HASP» and NOL may be set or 
reset dynamically through the console. For the syntax of the audit 
option in RJE» HASPs» and NOL» refer to the Mark V.Q» or higher» 
documentation of the-respective program(s). This revision of the 
B1700 DC/AUDIT product a supports the Mark VI.0 release 
of the progran. 


The audit files» OC/AUDIT.FILE» is maintained as a circular disk 
file. When this file gets filled» the oldest record is overwritten 
With the new record. This approach optimizes disk space and at the 
same time allows the user to monitor all data comm I/O activity. 
Futhermores if the data comm handler is aborted due to software or 
hardware malfunctions a permanent Feease of the Last "n™ records is 
still pvauleoLe on disk. 


The utility programs DC/AUDITs may be executed concurrently with the 
data comm handler and prints records written into the audit file.. 
The data comm handler and DC/AUOIT maintain synchronization through 

a mailbox (Crecord £0] of the audit file). DC/SAUDIT accepts several 

input parameters. By varying these input parameters» the printed 

output may pe structured so as to provide the most relevant 

information. 


This product specification describes DC/AUDIT: ~ its operating 
procedures along with the format of the audit file. 
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DC/AUDIT FILE IMPLEMENTATION 


CREATION OF AUDIT FILE 


When.a data comm handler receives a command to start monitoring data 
comm I/Q» the audit file is opened in the following manner: 


» OPEN AUDIT INPUTs OUTPUT» LOCK; 
ON FILE»MISSING <STATEMENT>3 
ON FILE.«LOCKED <STATEMENT>S 


The FILE-LOCKED condition indicates that the file is inaccessible 
. for output because another data comm handler has opened it with the 
LOCK options under this circumstance the handler will display a 
message and ignore the audit command. No two data comm handlers may 
Write to the same audit file at -the same time. This is enforced 
through the LOCK option of the OPEN statement. 


ae « 


The FILE MISSING condition indicates that the. file is not present. 
Each data comm handter is then responsible for the creation of a 
new audit fite. This is accomplished with the following statements. 


OPEN AUDIT INPUT» QUTPUT» NEW; 

- WRITE AUDIT £0] CRECORD); 
WRITE AUDIT CLAST] CRECORD)s % TO UPDATE EOF. 
CLOSE AUDIT LOCK, ; 


The close with LOCK option ensures that the file has been entered in 
the system dtrectory and that it is a permanent file. The handler 
then does another OPEN with the INPUT» OUTPUT» LOCK options. 


If the OPEN is successful Cneither on branch is executed)» then the 
file is tocked by the handler- This implies that no other handler 
has write access to ite. However» DC/AUDIT may still access’ the 
audit file on a read onty basis. If two audit sessions are 
initiated concurrently» then the two data comm handlers must access 
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different audit files; this may be accomplished through file 
equation. . 4 


Record zero of the audit provides the mailbox between the handler 
and DC/AUDIT. It contains two pointers» STARTePOINTER and 
NEXT»«AVAILABLE RECORD. The first points to the oldest record in the 
file and the second points to the next available Location in the 
audit file. Record zero also contains a count of all valid records 
CRECORDSeWRITTEN) in the file. 


On the first OPEN» the data comm handler , initializes 
NEXTeAVAILABLE.~RECORD and START.POINTER t06 one and RECORODS-WRITTEN 
to zero. On subsequent openss record zero is not initialized. 


The data comm handlers have options of opening and closing the audi 
_file = more than once during a data comm sessione In this case the 
START «POINTER will de updated so that it wilt stilt indicate all 
records relevant to the current user of the file. When the audit 
file is closed» the fields in reedrd £0] will delimit atl records 
which the current user has placed in the file. 


@ 


WRITING To THE AUDIT FILE 
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Hhen adding records to the audit files the data comm handter will 
write the record to. the location indicated by NEXT.AVAIL=~ 
ABLE-~RECORD. After each writes or group of writes» the data comm 
handler wilt update record C0] by rewriting it with 
NEXT«AVAILABLE-~RECORD' and RECORDS-WRITTEN updated. If the number of 
records written has caused the file to cycle Cthe number of records 
written is greater than the file size)» the oldest record will have 
been overwritten and. the START.POINTER 1s set equal to 
NEXT*AVAILABLEe¢RECORD to indicate that the file has cycled. In a 
cycled file START.-POINTER will be updated each time the 
NEXTeAVAILABLE.«~RECORD is updated. 


er, 
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When NEXT-»AVAILABLE-RECORD is greater than the size of the file» the 
data comm handler wilt detect an end of file ‘condition when 
attempting to write the next record. The data comm handler will set 
NEXTs«AVAILABLE»RECORD (Cand START.~POINTER if they are equal) to one 
and write the record again. 
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AUDIT DISK FILE - 


FILE DECLARATION 


The audit file is declared as follows: 


FILE AUDIT 
CLABEL = “DC™"/S™AUDIT.FILE™ >» 
DEVICE = DISK» RANDOM, 
RECORDS = 180/1>» 
AREAS = 10/100); 


‘With the above declarations the audit file can hold 1000 records. 
After the 10900th record» the next record overwrites the first 
record itnthe file and the file begins to cycle. On execution, 
-DOC/AUDIT opens the audit file nan@d DC/AUDIT.FILE as an input file. 


OPEN AUDIT INPUTs 


“ONeFILE.MISSING <STATEMENT>3 


If the file is missing» then it displays an appropriate message and 
terminates. The user may direct DC/AUDIT to read a different audit 
file through a file equate card. This will be required in the 
Situation where two handlers audit to two different files at the 
Same timee ; 


¢ 


“~ 


=_ 


RECORD ZERO 


The first record of the files record €0]» contains pointers’ that 
describe the state of the file. The format of record [0] is as 
follows: 
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O1 DISK.HEADER CHARACTER €180)> 
O02 NEXT.AVAILABLE-RECORD. BIT C024)» 
02 START.«POINTER BIT (O24)> 
O02 RECORDS-WRITTEN BIT (024)> 


O02 FILLER CHARACTER | (17103 


NEXT» AVAILABLE «RECORD points to the next ‘available Location in. the 
audit file. RECORDS.WRITTEN contains the total number of vatid 
records tn the audit file. 


DC/AUDIT formats’ and prints all records from the START-POINTER to 
the next pointer. Since the audit file is cyclical» an end of file 
condition merely causes ‘DC/AUDIT to initialize its record number to 
one and then to continue printings up to the next record pointer. 


DC/AUDIT may be run concurrently with the data comm handler. If 
DC/AUDIT catches up with the handlers it waits for "n™® seconds. On 
being awakeneds DC/AUDITs» will access record zero to determine § if 
there are any records to be printed. If there are no records» 
DC/AUDIT wilt wait once againe This allows the system to gain 
control when DC/AUDIT has no work. Figure 3.1 illustrates the audit 
file cycle. 
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DATA COMM HANDLER writes 
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Figure 3.1 OC/AUDIT Disk File Management 


3=4 


BURROUGHS CORPORATION : COMPANY CONFIDENTIAL 


SMALL SYSTEMS GROUP B1700 DC/AUDIT 


SANTA BARBARA PLANT : ~ ; - P.S.- 2212 5421 


TQ DESCRIPTOR RECORD CTYPE 1) 


The I0 descriptor record contains one entire IO descriptors» and if 
applicable, its buffer. If there is not enough room for the entire 
buffers the remaining portion of the buffer -will follow in 
continuation records. . a 


Descriptor and their related buffers are written to the file in 
order they were executed and written only after they have 
completed. 


The format of the I0 descriptor record is as follows? 


Oi IOQ.DESCRIPTOR.RECORD> 


02 TYPE BIT €(O04)» Z% CVALUE IS 1) 
O02 HEADER» . o 
03 TIME. START BIT €020)> 
03 TIME.FINISH " *  - BIY €020)>» 
03 PORT BIT (003), 
03 CHANNEL BIT (004)> 
03 ADAPTER BIT (€004)> 
03 FILLER BIT €016)> 
03 DESCRIPTOR.«DATAsADDRESS BIT (024)> 
03 DISPATCH.BIT BIT (001), 
02 DESCRIPTOR BIT (€272)> 
02 DATA.FIELD>s 
03 DATA.«LENGTH . BIT (024), 
03 DATA CHARACTER (€131)3 
RESERVED WORD MEANING 
TYPE: marks this record as a 


TOe.DESCRIPTOR. RECORD. 
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TIME.«FINISH 


DESCRIPTOR«DATAeADDRESS 


 DISPATCH.BIT 


DESZRIPTOR 
DATAsLENGTH 


DATA - 
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is the time that the descriptor was 
initiated. 


is the time that the descriptor 


completed. 


is the absolute address of the 
Result Field CRS) of. the I0 
descriptor. 


I f zero» it signifies that the 
descriptor was dispatched with a 
DC.INITIATE~10. If onesit signifies 
that the descriptor was initiated by. 
resetting the optcomplete bit in the 
RS field. 


~ 


is actual I0 descriptor. 


is the number of bytes in data. 


is the contents of the buffer. If 
the buffer length is greater than 
131 bytes» it will be continued in 
a CONTINUATION record that will 
immediately follow this 
IO0.-DESCRIPTOR.RECORD. 
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CONTINUATION RECORD CTYPE 2) 


The continuation record contains the continuation of a buffer that 
will not fit in a preceding I0 descriptor record or continuation 


record. ‘A continuation record must always follow an I0 descriptor 
record or another continuation record. 


The format of the continuation record is as follows: 
01 CONTINUATION. RECORDs> 


~ 


02 TYPE . BIT €004)»5 % VALUE IS 2 


O02 FILLER BIT (€364)> 
O02 DATA.»FIELDs>- : 
O03 DATA.LENGTH BIT (€024)> 
03 DATA CHARACTER (€131)3 
TYPE : marks this record as a continuation 
record. . 
' DATA.LENGTH ‘4s the number of bytes in DATA. 
DATA ; is the continuation of the buffer 


from the previous IO descriptor. 


“a 


A comment record is a record written by the data comm handler to 
provide additional information to the user of the audit file. 
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The format of the record is as follows: 


01 COMMENT.RECORD> 


02 TYPE BIT €004) % VALUE IS 3 

O02 HEADER» | 
03 COMMENT.TIME . BIT €020), 
03 FILLER BIT (072), 

02 FILLER | BIT (272)> 

O02 DATA.FIELD> : 
03 DATA-LENGTH BIT (024), 
03 DATA CHARACTER (131); 

TYPE a | which has a value of three» marks 


this record as a comment record. 
DATAeLENGTH js the number of bytes in DATA. 


DATA ; is the comment. 


Comment records may not have continuation records. 
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RUN TIME PARAMETERS 
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Upon execution of DC/AUDIT» the program witl look for aedisk file 
Labaled U"DC/PARAMETERS™ which contains the. run time parameters for 
DC/AUDIT.»« OC/AUCTT will read this file and process the parameters. 
If an error is found in the file the message: "PARAMETER FILE NOT 
VALIO™ will be aisplayed and the file ignored» requiring manual 
entry of the run time parameters. If an exception condition was 
realized when trying to read the file the message: "PARITY ERROR ON 
DISK FILE “DC/PARAMETERS™" FILE NOT USED™ wilt be displayed and the 
file ignoreds requiring manual entry of the run time parameters. 


The file labeled “DC/PARAMETERS” on disk can be ignored at execute 
time by setting switch 0 to any value other then zero. 


EXAMPLE2= EX DC/AUDIT SW 0 = Is 


The parameter entry» whether from a card. reader or console orinter» 
is free form. Parameters muS5t not have imbedded blanks and 
parameters with equal signs must end with a blank. 


If the file “"“DC/PARAMETERS”" is not on disk or the fila is in error 
‘or DC/AUDIT. has been instructed to ignore the file the following 
message wilt be displayed» indicating the manual entry of run time 
parameters to OC/AUDIT. i 


"DEFAULT PARAMETERS?" 


The operator can now enter run time parameters or use default run 
time parameters. 


cy 


mw 


The following are acceptable responses to “DEFAULT PARAMETERS 2%: 


<mix7index>Ax CPARAMETER LIST] is a List of run time 
parameters. 
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<mixmindex>AXKEND. means alt run time parameters entries 


from console printer are complete. 
This message is only valid after the 
console printer message "ENTER FURTHER 
PARAMETERS OR END™. 


<mixmindex>AXR means read the run time parameters 
from card file "CARDS" tLabetied 
WDC/PARAMETERS™. : 

<mix-index>AXYES means use all DEFAULT PARAMETERS. 


The error message INVALID PARAMETER DETECTED will be displayed if 
either of the following occurs: 


1. PARAMETERS LIST from the console printers the card reader or 
the disk file contained an invalid paraneter. 


2. Neither “"R%» "YES"» “END*® nor CPARAMETER LIST] was entered. 
Following the error message» an additional field indicating the last 


group of characters scanned dy ODC/VAUDTT is also displayed» to 
assist a user in correcting the error. 


If run time parameter entry is from the console printer» DC/AUDIT 
will display the following message after validating the previous 
entries: 


ENTER FURTHER PARAMETERS OR "END". 


If run time parameter entry is complete» the operator enters "END". 
Otherwise» the operator can enter—gore parameterse 


Notet "R, WYES" “and "END 
responding. ; 


ND. Slee 


fF immediately fotlow the AX when 
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PARAMETER DEFAULTS AND -FORMATS 


The following is an alphabetized list of default run time 
parameters. Specific run time parameters defaults are overridden by 
entry of that parameter in the card file “DC/PARAMETERS"™ or by 
entry of that parameter List on the console printer. 


PARAMETER and DEFAULT MEANING 

ADDRESS Print ports channel and adapter that 

IQ DESCRIPTOR was dispatched. 
DEFAULT: YNOWADORESS*™ 

ALL.»LINES Processes records tn the audit file 
from ati data comm Linas inctuded in 
the file. 

DEFAULT: TALLeLINES".« 

BUFFERS Qutput ali buffers associated with 
10 descriptor and the continuation 
records... 

DEFAULT: "BUFFERS. | 


DEL~LINE=CP2CsAy» P2CtAer «© « © ) : . 
hile a valid run time parameter» 
this is essentially designed to be 
used while DC/AUDIT is executing. 
The parameter defines specific lines 
which’. are not to ce audited. 
DC/AUDIT will delete the entry § for 
the lines entered from its list of 
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DEFAULT 
DISPATCH.BIT 

DEFAULT: 
DOUBLE 

DEFAULT: 


ERROR=(i»203 GR XXXXXX) 


DEFAULT: 
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lines to be audited. 


The format is similar to the "LINE=" 
parameter below. 


Alt tines are audited. 


Indicates whether [0 DESCRIPTOR was 
dispatched: by the MCP or by 
resetting tha complete bit of the I0 
DESCRIPTOR. . 


"NOeDISPATCH™ 


Double space each output Line. 


Sindte. 

If ERROR=1>» then output atl 
operations. 

If ERRGR=2> then Tqnore all 
operations that. completed with 


exceptions 


I-f ERROR=3>» then laqnore atl 
operations that completed without 
exception. 


If ERRGR=XXXXXX» than use XXXXXX» 
which will be the hex representation 
of a result descriptors as a mask to 
output: anly the XXXXXX result 
descriptor operations. 


ERROR=1 
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HEADER 

DEFAULT: 
IQ.DESC=C1»s> 2) 

DEFAULT: 
LENGTH=NANN 

DEFAULT: 
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Print a header at the top of each 


page. 


Headere 


If I8.DESC=l» then print the entire 
IO DESCRIPTOR in hex with each field 
separated by blanks. 


Tf IO.0ESC=25 then print just the 
Result Field. The result will be 
interpreted and printed in English. 


TOeDESC =2% ALt good result 
descriptors will be printed. 


NNNN iS a decimal number 1 to 4 
characters in Lenagthr which 
indicates the maximum number of 
characters in a buffer to print. 


The entire buffer will be output. 


This- narameter defines specific 
Lines which are to be audited. P:C:A 
are the ports channel and adapter 


address of eath line. Up to 16 Lines 
may be entered (Pre C and A must. be 
two decimal digits in tlenath and 
colons are required). 


BURRCUGHS CORPGRATI 


ON 


COMPUTER SYSTEMS GROUP 
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NO. ADDRESS 


NO.BUFFERS 


NOw~DISPATCH 


DEFAULT: 


DEFAULT: 


DEFAULT: 


DEFAULT: 


476 
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It is not ‘possible to enter all 
sixteen lines on one parameter 


record? consequently» additonal 


parameters are entered through ‘the 
"LINE=" optione If more than sixteen 
lines in total are entered into the 
DC/AUDIT tine’ list» ‘an error 
condition will occur. 


Example? LINE=07212:200207207:00 


ALL Lines are audited. 


Suppresses printing of the address 
toa which an 1/0 descriptor was 
dispatched. 


NO~ ADDRESS 


Do not print buffers associated with 
I0 DESCRIPTOR. 


Print all buffers. 


Does not print the manner in which 
a particular. [/0 descriptor was 
dispatchad. 


NO.DISPATCH - 
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NO«HEADER 


DEFAULT: 


OPS=(1l» 2 OR YY) 


DEFAULT: 


QUTPUT=CH OR A) 
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Do not print header at the top of 


each: pagee 


Header. 


If OPS=l- then output atl operation 
codes. 


If OPS=2» then output onty read and 
write operation codes. 


If OPS=Y¥» then use the hex mask 
indicated by CYY) to output the 
types of operation code that the 
user wishes to have monitored. 


YY BIT SETTINGS: 


6 


OGrmmais~ 

Md oe ft 
AYSemMuawo sw 
on 
wouwn + Ww 
ome amunma tn 
oma amomay tt ~ 
OMe AmMmMomna t+ o 


‘Example 3: If the user wishes toa 


display - read» write and break ops 
enter "EQ". 


OPS=1. 


Output=H will cause ODC/AUDIT to 
display ail buffers with an EBCDIC 
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DEFAULT: 


SINGLE 


DEFAULT: 


TIME=C{HH?2MM OR HHIMM>+HHIMMD 


DEFAULT: 
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representation of the hexadecimal 
code. 

Fxample: a@O1lABaQ will be —«- printed 
"OLAS". 


Dutput=A will cause DC/AUDIT to print 
all ouffers in atpha format. Atl 

graphics are printed» alt special 

characters are printed by their name 

and all other characters are printed 

in EBCDIC representation of their 

hex cod@e _ 


Example: a01iCiC2C 335039 will be 
printed <SOH>ABCE351<ETX>. 


OUTPUT =A. 


Single space each output tine. 


Single. 


Time gives a start for the audit 

rune Any record entered with a tine 

less than specified here wiltt be 

ignored. 

HH2MM represents hours and minutes in 


military representation. 


A second time is a stop time. File 
will be audited from first HH:MM to 
second HH:MM. 


ALL the records from the last 
session are printed. 
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DEFAULT PARAMETERS 


The following is the List of run time parameters that wilt be 
specifted if the response to USE OEFAULTS? is “YES”. 


ALL«LINES 
BUFFERS 
ERROR=1 
HEADER 
IO0.DESC=2 
NO.sADDRESS 
NO.DISPATCH 
OPS=1 
QUIPUT=A 
SINGLE 


There will oe no ‘indication of how 10 was dispatched or port, 
channel and adapter that I0 was dispatched: to. All tines and 
buffers will be output. 


e 


PARAMETER LIST ENTRY 


= ae ow OF tn 28 RS 20 OP a Oe ge OO OR ee 


If the operator desires to override one or more of the default run 
time parameters» he enters "R®™ or CPARAMETER LIST] in response to 
"DEFAULT PARAMETERS?™. 


If the entry is through a [TPARAMETER LISTI on the console orinter>» 
the operator can enter up to 72 characters containing one or more 
parameters ta override the DEFAULT PARAMETERS. A parameter entry 
must be contained wholly in the conscle printer respons@. 
Additional entries can pe entered after OC/AUDIT disolays; 


ENTER FURTHER PARAMETERS QR “END*® 
If entry ts through a card reader or a disk filer each card can 


contain one or more parameters» put each parameter entry must be 
contained wholly on one card or one record. 
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The parameter entry» whether from a card reader or console printer 
is free form. Parameters must not have imbedded blanks) and 
parameters with equal signs must end with a blank. 


If an error is detected (invalid keyword or value) the parameter 
scan is ended and the following error message is displayed: 


INVALID PARAMETER DETECTED 


The operator must re~submit the entire List of parameters again. 
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OPERATING INSTRUCTIONS 


Upon execution of DC/AUDIT» the following message wilt be displayed 
after the regular system messages. 


DEFAULT PARAMETERS? 


Run time parameters are entered at this tine. After verifying the 
parameterse OC/AUDIT will access the audit file. If the audit file 
is not presents CC/AUBDIT will display: 


FILE DC/AUDIT.FILE NOT PRESENT 


and go to end of joo. 


If the file is present DC/AUDIT will pewe record zero and start to 
output the audit file per the run time parameterse 


If running in the offline modes» DC/AUDIT will itself go to end of 
job. when it has processed the entire file Cas defined by record 
zero). Khen running in the online mode and no new entries have oeen 
made to the audit file for a period of one minutes DC/ZAUDIT will 
interrogate the files and if no other program is using the file Can 
indication that the generating program has gone to EDOJ)» DC/AUDIT 
will itself go to EQJ. 


The operator ‘can stop DC/ AUDIT or interrogate DC/AUDIT with the 
following commands: ee 


<mix-index>AXwy causes OC/AUDIT to display a summary 
accounting o f records read and 
written. OC/AUDIT continues to output 
the audit file. , 


BURRCUGHS CORPORATION 
COMPUTER SYSTEMS GROUP 
SANTA SARBARA PLANT 


<mix-index>AxTo 


<mix“index>AXsT 


<mx>AX<PARAMETER LIST> 


5<2 


COMPANY CONFIDENTIAL 
B1700 DC/AUDIT 
P.S. 2212 5421 


causes DC/AUDIT to display all the 
parameters and their settings under 
which DC/AUDIT is running. 


causes OC/AUDIT to print a summary 
accounting. of records read and 
Written. DC/AUDIT then goes to end of 
job. 


causes DC/AUDIT to change its run time 
parameters whtle processing the audit 
file. The format of the parameters are 
the same as-the paraneters entered at- 
the beginning of jobs with the 
exception that the TIME parameter will 
not be accepted. If the new parameters 
entered are different enough fron 
those previously entered» DC/AUDIT 
will skip to the top of a new page anda 
print a new page headars if the HEADER 
Darameter is seat. The LINES= parameter 
when entered will add additional lines 
to the List of those checked by 
DC/SAUDIT. In order to delete lines 
from this Lists» - the ALL.LINES 
parameter must be first entered and 
then the new line List with the LINE= 
parametere - : ; 


OUTPUT 
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FILES 

INPUT 


RUN TIME PARAMETER FILE 

CARDS LABELED "DC*/"PARAMETERS" 
RECORD SIZE = 89 

BLOCKING 1 RECORD PER BLOCK 
DEVICE 15 CARD 


AUDIT FILE 

AUDIT LABELED "OC/AUDIT« FILE™ 
RECORD SIZE = 180 

AREAS, = 10 

BLOCKS PER AREA = 100 

DEVICE IS RANDOM DISK 


PRINT FILE 

QUT LABELED "DC/PRINT.FILE™ 
RECORD SIZE = 132 . 

BLOCKING 1 RECORD PER BLOCK .- 
DEVICE 15 PRINTER OR BACKUP DISK 


BURROUGHS CORPORATION 
SMALL SYSTEMS GROUP 
SANTA BARBARA PLANT 


CONSOLE 


Console printer messages output 
alphabetical order: 


MESSAGE and RESPONSE 


DEFAULT PARAMETERS? 


RESPONSE? 
-"OC/AUDIT.FILE” NOT PRESENT 
RESPONSE? 


. 


INVALID MESSAGE TYPE 


7~1 
COMPANY CONFIDENTIAL 


B1700 OC/AUDIT 
PeSe 2212 5421 


PRINTER MESSAGES 


- om Be UE te EY wD ae he om ae O82 ND a 


by DC/AUDIT are as ‘follows’ in 


MEANING, 


Enter run time parameters. 


Variable. See RUN TIME PARAMETERS. 


OC/AUDIT could not Locate the audit 
file. DC/AUDIT will now go to end of 
job. : 


None. 


“Neither WYs ST» nor a valid 


paremater was entered after DC/AUDIT 


‘ processing had - started. The 


RESPONSE: 


additional characters printed 
following this message are the last 
charactes scanned by the program 
before the error was encountered. 


Enter WY» ST» or a valid parameter. 


BURROUGHS CORPORATION 
SMALL SYSTEMS GROUP 
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INVALID PARAMETER DETECTED 


RESPONSE: 


INVALID RECORD TYPE RECEIVED 


RESPONSES 


NO RECORDS PRESENT IN FILE 


RESPONSE: 


PARAMETER FILE ON BOISK 
NOT VALID 


RESPONSE: 


@ 


PARITY ERROR ON DISK FILE 
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Error was detected while analyzing 
run time parameters. The additional 


chatacters printed following this 
message are the Last characters 
scanned by the program before the 


error was encountered. 


Correct and reenter parameters. 


A record was read from DC/AUDIT.FILE 
with a TYPE value not equal to 1s 2, 
or 3 ODC/AUDIT wilt dump itself,» 
print a summary report and go to end 
of job. 


None 


Audit file was empty. DC/AUDIT will 
now go to end of job. | 


None. 


The disk file "DC/PARAMETERS™ was in 
error. Run time parameters will be 
entered from card or the console 
printer. The additional characters 
printed following this message are 
the last characters scanned by 
DC/AUDIT © before the error Was 
encountered. 


Enter correct parameters from card 


“or console printer» or. correct disk 


file and rerexecute OC/AUDIT. 


BURROUGHS CORPORATION 
SMALL SYSTEMS GROUP 
SANTA BARBARA PLANT 


"DC/PARAMETERS" FILE NOT-USED 


RESPONSE: 


UNEXPECTED “"EOF™ FOUND 
ON AUDIT FILE 


RESPONSES 


TYPE2 RECORD OUT OF SEQUENCE 


RESPONSE? 
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DC/AUDIT obtained an error trying to 
read . the disk file containing the 
run time parameters. The run time 
parameters wilt have to be entered 
from card or console printer. The 


‘additional characters printed 
following this message are the Last 


characters scanned by OC/AUDIT 
before the error was encountered. 


Enter correct parameters from card 
or console printers or correct the 
disk file and remexecutée DC/AUDIT. 


E OF was returned on read of first 
record in audit. fite. A summary 
report is printed and DC/AUDIT will 
go to end of job. “ 


- 


Nonee 


A TYPE 2 record does not follow a 
TYPE 1 reeord or another TYPE: 2 
record. <A Summary report is printed 
and DC/AUDIT will go to end of job. 


None. 
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QUTPUT FORMATS 


There are four basic output formats with some additional fields 
printed depending on run time parameters selected. The four basic 
formats are: 


Ae Format 1 Result descriptor is interpreted and 
output = In English. Data written or 
read from operation is printed. 


Be Format 2 Result descriptor is interpreted and 
output in English. Data written or 
read from operation is not printed. 


Ce Format 3 Att fields of the IO DESCRIPTOR are. 
output in hexadecimal representation. 
Data written or read from operation is 
printed. 


D. Format 4 ALL fields of the I0 DESCRIPTOR are 
output in hexadecimal representation. 
‘ Data written or read from operation is 

not printed. . 


_ With every output format» when an I/0 descriptor record is being 
printed» columns 12 thru 18 of the printed Listing wilt be used to 
indicate the type of I/0 descriptor. There are four basic types 
namely» "READ™s “WRITE™» "STOP™ and "TEST™. A number of variants 
are possible. For a read I/0 descriptor either "RD.NTIM”™ CRead No 
Time Out)dre "RDw~APOL™ (Read Autopoll)d» "RD.~NEOT*® (Read No EDT)» or 
"READ™. may be printed depending on the options set in the I/0 
descriptor. For awrite I/0 descriptors either "WReAPOL™ (CWrite 
Autopolt), “"WR.NEQT™ CWrite No EOQT)» or *WRITE® may be printed. A 
stop I/0 descriptor will thave either "DISCONN"™ CDisconnect)>, 
"BREAK" or "™STOP™ printed. A test I/G descriptor will have 
"TESTRNG™ (Test and Wait for a Ringing Phone). "TESTDSR™ (Test and 
Wait for "DATA SET READY™)» or TEST. 
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In case of a READ or WRITE [7/0 descriptors if more then one variant 
had been sets» only one will be indicated on the Listing. The 
priorities of read and write variants are Listed below. 


READ WRITE 
RDeAPOL WReNEOT 
RD. NEOT _ WRITE 
READ 


If a simple "TEST" I/0 descriptor is processed» an additional field 
will be printed on the Listing namely “ADAPTER.ID = XX" indicating 
the type of adapter the descriptor was issued against. 


OUTPUT FORMAT 1 


Output format 1 185 generated when the run time parameter default of 
I0.DESC=2 . is specified and NO«.BUFFERS has not been specified. If 
the header parameter is specified each page wilt have the following 
header format: 


ereee BO1700 DC/AUDIT <DATE TIME> «eax 
TIME OP BUFFER RESULTS 


Records from the audit file will be output in the format described 
by Figure 8.1. 
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NN&NNZNN AAAAAAA OATA NN?NN2NN BBBBB LENGTH=NNNN CCCCC 
* * * * * Length of data * 
* Gp TYPE. * If ADDRESS * read or writtene * 
* ‘ * parameter» * * 
* * this will be * * 
* Ports Channel * . * 
For read op» * and Adapter * English inter- 
time op com- * that I0 des= »* pretation of 
pleted. All * criptor was k abnormal com 
other ops» * issued toe * pléetions. Nor- 
time ops were * * mat completion 
dispatched. * : * will be blank. 
, * * 
Data written or read. If e 
OUTPUT=A» data will consist * 
of graphics» special tine * 
controt characters with * 
their names enclosed in Rk RKKK - 
< >» and non~graphics with * 


each four bits in hexa-~ 
decimal representation 
enclosed in { J]. Characn- 
ters "£? and *IJ" will 

be treated as non 
graphics. EXAMPLE 

<STX> CECI] ABCI2 <ETX> 


If OUTPUT=H each four 
bits of data wilt be 
in hexadecimal repre 
sentation. 

EXAMPLE 


QLEECIC2C3SF1LIF 293 


Figure 8.1 Audit File: 


This fietd wilt appear 


-if DISPATCHED.BIT para~ 


meter was specified. I f 
10 was initialized by 
resetting the I0 complete 
bits» “RESET™ will be 
pr-inted. If I0 was 
initialized by a dispatch 
communicate to the MCPs» 
"DISPATCHED" wilt be 
printed. 


Outout Format 
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OUTPUT FORMAT 2 


OUTPUT FORMAT 2 generated when default run time parameter IOQ.DESC=2 
is specified and NO-BUFFERS is specified. If the header parameter 
is specified each page will have the fotlowing header format: 


 &eeee BO1700 DC/AUDIT <DATE AND TIME> *«8«x 
TIME OP RESULTS 


Records from the audit file will be output in the format described 
by Figure 8.2. 


- 
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NNSNNSNN AAAAAAA 


* 

* Op TYPE 
kw: 

& 


For read op» 
time op com~ 
pleted. All 
other opSe 
time ops were 
dispatched. 


COMPAN 


This field will appear. 


“if DISPATCH-BIT parameter 


was specified. If I0 was 
initiated by resetting the 


10 complete bit “"RESET™ will 


be printed. If [10 was - 
initiated by a dispatch 
comunicate to the MCP» 
"DISPATCH™ will be 
printed. 
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NN2NN2NN BBBBB LENGTH=NNNN CCCCC 


. & * Length of data * 
If ADDRESS * read or written. * 
parameters * * 
this will be «x * 
Ports Channel * * 
and Adapter * English inter 
that I0 des= * pretation of 
criptor was * abnormal com- 
issued to. * pletions. Nor= 
* mal completion 
* _ will be blank. 
* 
“e 


Figure 8.2 Audit File: Output Format 2 
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OUTPUT FORMAT 3 


QUTPUT FORMAT 3 generated when run time parameter I0.DESC=1 is 
specified and NO.BUFFERS is specified. If the header parameter is 
specified each page will have the following header format: 


keeke Bo 1700 DC/SAUDIT <DATE TIME> xx«« 
TIME OP. BUFFER DESCRIPTOR © 


Records from the audit file will be output itn the format described 
by Figure Bade 
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NNSNN2NN AAAAA DATA AE=XXXxXxXx RS=XxXXXXX LK=XXXXXX OP=XKXXXXX 
Saree HS est ate SA=XXXXXX EA=XXXKXKX MS=XXXXXK KXXXKX 

* * * XXXXKX KMXXKKXK KXKXXXKXX X x X LENGTH=nnnn 

* Op TYPE ei 9 a a a ik nao Sg ne ee lo ea 

* * * 

* Data written or read... . Hexadecimal repre- 

* ° See Figure 8.1 for sentation of I0 

* format of data. ; descriptor. 

" 
For read op» AE = Actual Ending Address 
time op com RS = Result Descriptor 
pleted. For LK = Link Address 
all. other ops» OP = Operation = 
time op was SA = Start Address 
dispatched. EA = End’ Address 

MS = MCP Work Area 


Figure 8.3 


If ADDRESS parameter and/or DISPATCH.BIT 
parameter is specified» the Ports» Chan~ 
nel and Adapter and RESET or DISPATCHED 
Will precede LCENGTH=nnnn. . 


LENGTH= is Length of data read or writ- 
tene 


Audit Fite: OQutput Format 3 


8-8 


BURROUGHS CORPORATION COMPANY CONFIDENTIAL 
SMALL SYSTEMS GROUP B1i700 DC/AUDIT 
SANTA BARBARA PLANT P.Se 2212 5421 


OUTPUT FORMAT 4 


OUTPUT FORMAT 4 is generated when run time parameters I0-DESC=1 and 
NOw.BUFFERS are specified.e If the HEADER parameter is specified each 
page will have the following header format: 


‘ teeexe Bo 1700 DC/SAUDIT <DATE TIME> xxx 
TIME QP DESCRIPTOR 


Records from the audit file wilt be output in the format described 
in Figure 8.4. 
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NNSNNSNN AAAAAAA PPSCCZAA B 


2 
* Op TYPE 
* 


For read ope 
time op com= 
pleted. For 

all other 

ops» time op 
was dispatched. 


* + + eH eH FH HF FH HR 


; : *% 
If ADDRESS parameter 
was defineds this 
will be Ports Chan= 
nel and Adapter 

that I0 was issued: 
to. 
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BBBB LENGTH=NNNN AE=xXxxxxxx RS=xXxXxXxxx 


Soe. Se = ee oe ee LK=xXxxXxxxx OP=xXxXxxxX 
* ° Length of SA=KKXXXK EA=XKXXXXX 
* data read MS= 
* or written. “Sst ee eee eneewee 
* * 

* z : * 

a Hexadecimal value 
* of the I0 descrip- 
* tor. 

* 

* AE = Actual Ending Address 
* RS = Result Descriptor 

* LK = Link Address. 

* OP = Oper.ation 

* SA = Start Address 

* EA = End Address 

* MS = MCP Work Area 

* 

* 

* 

* 


This field will appear 
if DISPATCH.BIT para~ 


meter was 
If I0 was 
by resett 
complete 

Will be p 
I0 was in 
dispatch 

to the MC 
Will. be p 


Figure 8.4 


specified. 
initiated 

ing the -I0 
bit "RESET" 
rinted. If 
itiated by a 
communicate 
P» “NISPATCHED™ 
rinted. 
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